// File: jmcomic-core/src/main/java/dev/jukomu/jmcomic/client/JmUserClient.java
package dev.jukomu.jmcomic.client;

import dev.jukomu.common.util.net.IResponse;
import dev.jukomu.jmcomic.entity.JmFavoritePage;

/**
 * 对应Python的JmUserClient，定义用户相关操作的接口。
 */
public interface JmUserClient {

    /**
     * 用户登录。
     *
     * @param username 用户名。
     * @param password 密码。
     * @return 响应对象IResponse。
     */
    IResponse login(String username, String password);

    /**
     * 评论漫画/评论回复。
     *
     * @param videoId    本子ID或章节ID。
     * @param comment    评论内容。
     * @param originator 原始评论者（如果回复）。
     * @param status     是否有剧透（true/false）。
     * @param commentId  被回复的评论ID。
     * @return JmAlbumCommentResp对象。
     */
    JmAlbumCommentResp albumComment(String videoId, String comment, String originator, String status, String commentId);

    /**
     * 获取收藏夹内容。
     *
     * @param page     页码。
     * @param orderBy  排序方式。
     * @param folderId 收藏夹ID。
     * @param username 用户名（网页端需要）。
     * @return JmFavoritePage实例。
     */
    JmFavoritePage getFavoriteFolder(int page, String orderBy, String folderId, String username);

    /**
     * 将本子加入收藏夹。
     *
     * @param albumId  本子ID。
     * @param folderId 收藏夹ID。
     * @return 响应对象IResponse。
     */
    IResponse addFavoriteAlbum(String albumId, String folderId);
}